home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1999 March / EnigmA AMIGA RUN 35 (1999)(G.R. Edizioni)(IT)[!][issue 1999-03].iso / earcd / -archivi / -recent1 / nsm_tnw041b.lha / tracknameswindow / tracknameswindow.doc < prev    next >
Text File  |  1999-02-21  |  9KB  |  201 lines
  1.  
  2.     TracknamesWindow for Octamed 1.03c!
  3.     Current version 0.41b.
  4.     Made by Kjetil S. Matheussen 1999.
  5.  
  6.  
  7. THE GOOD THINGS!
  8.     (sort of important stuff too, I guess)
  9.  
  10.     This is a small configurable window that displays the track-names, the
  11.     keyboardoctave, the current track, on/off status of the visible
  12.     tracks, volume of the current instrument, midichannel/samplelength of
  13.     the current instrument, and the name of the current instrument. I personally have now
  14.     replaced the maincontrol-window with this window in my octamed, and have
  15.     earned quite some screenspace just on that.
  16.  
  17.     You specify the track-names with the included plug-in named
  18.     "tnwcontrol". Press a shortcut-key, and a menu will be visible.
  19.     The alternatives should be self-explaining. If you just want
  20.     to set the new name of the track, simply just write the new name,
  21.     and press return.
  22.  
  23.     The tracknames are saved into the annotation-text,
  24.     so you don't need two seperate files for each song.
  25.  
  26.  
  27. THE BAD THINGS:
  28.  
  29.     Installation of the window. You should start the window-plug-in by putting
  30.     the following line into your "rexx:om_startup.omed"-file. If you don't
  31.     have such a file, just copy the included "om_startup.omed"-file in this
  32.     package into your rexx: path. Yes, the line is:
  33.  
  34.     ADDRESS COMMAND "run >NIL: nsm:tracknameswindow"
  35.  
  36.     ...And this may be all you have to do. But the window can look uglier than
  37.     ugly. So then you can either try a different font for the editor, or try
  38.     to experiment with the following arguments that can be sent along with the
  39.     command-line.
  40.  
  41.     Here they are: (All argument are optional)
  42.  
  43.     -stoptaskprior [n]       - n = Is the priority of the task while not playing. Is set
  44.                                    to 8 by default.
  45.     -playtaskprior [n]       - n = Is the priority of the task while playing. Is set to
  46.                                    -20 by default.
  47.     -ypos [n]                - n = the Y coordinate the window will start at. F. ex: 10.
  48.                                    This is actually an argument you most probably want
  49.                                    to set. I have hardcoded it to 10, because that
  50.                                    fits my look. But it may not fit your look.
  51.     -editorfontname [n]      - n = the name of the editorfont. F.ex: Topaz.font. Should
  52.                                    not be necesarry to spesify, since the plug-in peeks
  53.                                    into the memory and find the font octamed is using
  54.                                    for the editor. But I have had some problems with
  55.                                    that routine...
  56.                                    Just forget this argument if the track-seperator-lines
  57.                                    in the tracknameswindow are placed in the middle
  58.                                    between each track in the editor.
  59.     -editorfontsize [n]      - n = size of the editorfont. F. ex: 8. If you specify the
  60.                                    editorfontname, you *must* allso spesify its size,
  61.                                    und viseversa.
  62.  
  63.     -windowheight [n]        - n = the height of the tracknameswindow. F. ex: 30.
  64.  
  65.     -topmarkcursorpos [n]    - n = The top relative Y coordinate of where the top-line
  66.                                    marker will be placed. (the cursor)
  67.     -botmarkcursorpos [n]    - n = The bottom relative Y coordinate of where the bop-line
  68.                                    marker will be placed. (the cursor)
  69.     -fontpos [n]             - n = The Y coordinate of where the text in the tracknames-
  70.                                    window will be placed.
  71.     -whitelinetop [n]        - n = The top Y coordinate of where the white lines will
  72.                                    start. "White lines" means the vertical lines that seperate
  73.                                    your tracks.
  74.     -whitelinebot [n]        - n = The bottom Y coordinat of where the white lines will
  75.                                    end.
  76.  
  77.     Ok. If you didn't quite catch what all this arguments did, just try them out one
  78.     at a time, and you'll see what happens. It's the 6 last ones that are important for the
  79.     look of your window. (Important to set, so that it doesn't look awful.).
  80.  
  81.  
  82. CHANGES
  83.     Changes from 0.41 to 0.41b:
  84.     -The "Insert track(s) in current block"-function in the tnwcontrol-
  85.      program didn't work. Fixed.
  86.  
  87.     Changes from 0.40 to 0.41:
  88.     -Fixed some bugs.
  89.     -Added a tracknamebuffer.
  90.     -Some small speed-improvements.
  91.     -Added the plug-ins copytrack,cuttrack and pastetrack.
  92.  
  93.     Changes from 0.30 to 0.40:
  94.     -Added a lot of new features. F.ex different tracknames for each block.
  95.     -Fixed a lot of bugs. F.ex that the requester-window opened at the workbench-screen
  96.      instead of the octamed-screen if you hadn't installed some kind of con-handler that
  97.      prevents a con-window from doing this.
  98.     -Doesn't need to use the update plug-in anymore. (its not a part of the package
  99.      anymore either.)
  100.  
  101. REQURIMENTS
  102.  
  103.     1. Octamed Soundstudio 1.03c, patched with the octapatch-program in the
  104.     nsm-package.
  105.     2. Nsm-port program started. Found in the nsm-package.
  106.     3. That you have the file named "plainnames" in a path called "nsm:"
  107.     before starting the tracknameswindow. If not, octamed will probably
  108.     crash, or something. (This is hardcoded, you *must* have the file
  109.     "nsm:plainnames". And if its not of the right type, you can crash octamed.)
  110.     The plainnames-file is in this package, and should be copied automaticly
  111.     to nsm: if NSM is installed correct.
  112.  
  113.  
  114. INSTALLATION
  115.  
  116.     1. Install NSM V0.70 or higher.
  117.     2. Unpack the tracknameswindow archive into the plug-in directory of nsm.
  118.     3. If your user-startup file doesn't copy all your plug-ins into your nsm:
  119.        path automaticly, you must do point 3 in the REQUIREMENTS.
  120.     4. Put the following line into your "rexx:om_startup.omed"-file:
  121.         ADDRESS COMMAND "run >NIL: nsm:tracknameswindow" (plus various arguments)
  122.         If you don't have an om_startup.omed-file in your rexx-path, just copy
  123.         the one in this archive into your rexx-path. "rexx:om_startup.omed" are
  124.        an arexx-script that is executed automaticly by octamed on every startup.
  125.     5. Set the argument "ypos <n>" to an apropriate value. This is the Y-position
  126.        of your window on the screen. 0 is in the top of your screen.
  127.     6. If window look ugly, read "THE BAD THINGS".
  128.     7. Well, I think that was all.
  129.  
  130.  
  131.  
  132. USAGE
  133.     1. Use the plug-in named "tnwcontrol" to set the name of the tracks, and
  134.     other things.
  135.     2. Use the plug-in named "quittracknameswindow" to quit the window. Beware
  136.     that you'll have to quit the window before you can exit octamed. If you try
  137.     to exit octamed before you run the "quittracknameswindow"-plug in, you may
  138.     run into some trouble, yes. Read source-file for more info.
  139.  
  140.  
  141. BUGS
  142.     Yes, probably a lot! But this to are the only one I know of:
  143.     1. When you have 64 tracks in a block,
  144.     and try to move the cursor to track no 63. What a race! I have no idea why
  145.     this happens. I have disassembled and gone thru the code quite many times,
  146.     but just can't find out why this happens. (It only happens if you use 64 tracks).
  147.     2. The isplaying-function doesn't allways work,
  148.     so the tracknameswindow does sometimes have the nonplaying-priority when playing,
  149.     and sometimes playing-priority when not playing. This is a quite serious bug,
  150.     but I will fix it in the beginning of 99. Should be quite easy to fix.
  151.     3. The keyboard-octave doesn't allways work, but thats because of a bug in octamed.
  152.  
  153.  
  154. FAQ
  155.     1. There are no text in the tracknames-window.
  156.         -Change the editor-font. Your font does probably not excist, so just
  157.          set it to a spesific font. (topaz8 is probably what you are using then.)
  158.     2. Nothing work!
  159.         -Have you read the USAGE and INSTALLATION chapters? If you have, mail me
  160.          your configuration, and I will answer you.
  161.     3. The tracknameswindow doesn't show right midi-channel/samplelength.
  162.         -Open the maincontrol-window. If it is allready open, close it and open
  163.          it again.
  164.     4. The keyboard-octave doesn't cycle when pressing F1 or F5.
  165.         -Open the maincontrol-window. This seems to be a bug in octamed, not
  166.          in tracknameswindow.
  167.  
  168.     And, read the BUGS-section.
  169.  
  170.  
  171. TODO
  172.     1. A cople of more arguments to improve the graphical display.
  173.     2. Fix the program so that the graphical display is perfect at startup whatever
  174.     font you are using. (_lot_ of work)
  175.     3. Write a better manual.
  176.     4. Make a handshakefunction. (or something.)
  177.  
  178.     And again, feel free to do this things if you wants to. Just contact me to
  179.     know if there are someone else who is allready working on it.
  180.  
  181.  
  182. THANKS!
  183.     Teijo Kinnunen for making such a wonderful program that can be built
  184.     out to do everything! (If you had released the source too, everyting
  185.     would be perfect. :)
  186.  
  187.  
  188. CONTACT
  189.  
  190.     Kjetil S. Matheussen
  191.     5423 Sogn Studentby
  192.     0858 Oslo
  193.     Norway
  194.  
  195.     e-mail: kjetilma@ifi.uio.no
  196.  
  197.     nsm-homepage: http://www.stud.ifi.uio.no/~kjetilma/nsm/
  198.     octamed-homepage: http://www.octamed.co.uk/
  199.  
  200.  
  201.